Get Job

Imagine having a list of transcription jobs and wanting to fetch the details of a specific one. The Get Job API endpoint is like searching through a catalog to find the exact item you're looking for. It filters all jobs and returns the one that matches the provided job ID.

Endpoint

https://api.betatel.com/api/v1/stt/job/:jobId

Replace :jobId with the actual job identifier to retrieve the details and status of your transcription request.

Parameter	Value	Description
jobId	string	The unique ID representing your transcription job.

Headers

Guard the gates with these important headers:

Param	Value	Description
x-api-key	{{x-api-key}}	Your unique API key for secure access.
x-user-id	{{x-user-id}}	Your user identifier for added security and tracking.

Code Snippets

Here are different spells (code snippets) to summon the status of your transcription job.

cUrl

Example - cURL

var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Get, "https://dev.api.betatel.com/api/v1/stt/job/:jobId");
request.Headers.Add("x-user-id", "6757f3ffb5e62f0ce0e513a2");
request.Headers.Add("x-api-key", "••••••");
var response = await client.SendAsync(request);
response.EnsureSuccessStatusCode();
Console.WriteLine(await response.Content.ReadAsStringAsync());

Python

Example - Python

import http.client

conn = http.client.HTTPSConnection("dev.api.betatel.com")
payload = ''
headers = {
  'x-user-id': '6757f3ffb5e62f0ce0e513a2',
  'x-api-key': '••••••'
}
conn.request("GET", "/api/v1/stt/job/:jobId", payload, headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))

Node.js

Example - Node.js

const axios = require('axios');

let config = {
  method: 'get',
  maxBodyLength: Infinity,
  url: 'https://dev.api.betatel.com/api/v1/stt/job/:jobId',
  headers: {
    'x-user-id': '6757f3ffb5e62f0ce0e513a2',
    'x-api-key': '••••••'
  }
};

axios.request(config)
.then((response) => {
  console.log(JSON.stringify(response.data));
})
.catch((error) => {
  console.log(error);
});

PHP

Example - PHP

<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://dev.api.betatel.com/api/v1/stt/job/:jobId',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'GET',
  CURLOPT_HTTPHEADER => array(
    'x-user-id: 6757f3ffb5e62f0ce0e513a2',
    'x-api-key: ••••••'
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

Java

Example - Java

Unirest.setTimeouts(0, 0);
HttpResponse<String> response = Unirest.get("https://dev.api.betatel.com/api/v1/stt/job/:jobId")
  .header("x-user-id", "6757f3ffb5e62f0ce0e513a2")
  .header("x-api-key", "••••••")
  .asString();

C#

Example - C#

var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Get, "https://dev.api.betatel.com/api/v1/stt/job/:jobId");
request.Headers.Add("x-user-id", "6757f3ffb5e62f0ce0e513a2");
request.Headers.Add("x-api-key", "••••••");
var response = await client.SendAsync(request);
response.EnsureSuccessStatusCode();
Console.WriteLine(await response.Content.ReadAsStringAsync());

Response

A confirmation message will be returned, indicating the successful retrieval of the selected jobs.

🎉 Congratulations

With this endpoint, you're one step closer to transforming audio into actionable insights. Whether you're building a podcast archive, voice assistant, or research tool, the Get Job endpoint is your window into progress. Happy transcribing!